Skip to main content

answer folder

Type

command

Summary

Displays a standard file dialog for the user to choose a folder.

Syntax

answer folder <prompt> [with <defaultPath>] [titled <windowTitle>] [as sheet]

Description

Use the answer folder command when you want the user to choose a folder --for example, as a destination for exported files.

If the as sheet form is used, the dialog box appears as a sheet on OS X systems. On other systems, the as sheet form has no effect and the dialog box appears normally. Attempting to open a sheet from within another sheet displays the second stack as a modal dialog box instead. To give a dialog box a prompt when using the as sheet form a non-empty title must be provided. This will cause the prompt to appear in the same place it would if as sheet was not being used.

If the systemFileSelector property is set to false, LiveCode's built-in dialog box is used instead of the operating system's standard file dialog.

Parameters

NameTypeDescription

prompt

string

If you specify empty, no prompt appears.

defaultPath

The name and location of the folder whose contents are listed when the dialog box appears. If no defaultPath is specified, the dialog box lists the contents of the last folder you used with a file dialog box.

windowTitle

If specified, appears in the title bar of the dialog box. If no windowTitle is given, the title bar is blank. This parameter has no effect on macOS 10.11 (El Capitan) and above, so make sure that any important information is placed in the prompt parameter.

Examples

answer folder "Please choose a folder:"
if it is empty then answer folder chooseMsg as sheet
answer folder "Where is the data?" with "../data_stacks/recent"

command: answer file, revDeleteFolder

function: result, files

glossary: property, return, variable, modal dialog box, export, file dialog box, folder, command, dialog box

keyword: it

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

Thank you for your feedback!

Was this page helpful?